<TITLE>alarm</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>



<h3>ALARM(2)            Linux Programmer's Manual            ALARM(2)
</h3>

<h3>NAME
</h3>       alarm - set an alarm clock for delivery of a signal

<h3>SYNOPSIS
</h3>       #include &lt;unistd.h&gt;

       long alarm(long seconds);

<h3>DESCRIPTION
</h3>       alarm arranges for a SIGALRM signal to be delivered to the
       process in seconds seconds.

       If seconds is zero, no new alarm is scheduled.

       In any event any previously set alarm is cancelled.

<h3>RETURN VALUE
</h3>       alarm returns the number of seconds  remaining  until  any
       previously  scheduled  alarm  was  due to be delivered, or
       zero if there was no previously scheduled alarm.

<h3>NOTES
</h3>       alarm and setitimer share the same  timer;  calls  to  one
       will interfere with use of the other.

       Scheduling delays can, as ever, cause the execution of the
       process to be delayed by an arbitrary amount of time.

<h3>CONFORMING TO
</h3>       SVID, AT&T, POSIX, X/OPEN, BSD 4.3

</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=setitimer.htm>setitimer</a>, 
<a href=signal.htm>signal</a>, 
<a href=sigaction.htm>sigaction</a>, 
<a href=gettimeofday.htm>gettimeofday</a>, 
<a href=select.htm>select</a>, 
<a href=pause.htm>pause</a>, 
<a href=sleep.htm>sleep</a>, 
<pre>























<h3>Linux                      21 July 1993                         1
</h3>

</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>

This manual page was brought to you by <i>mjl_man V-2.0</i>
